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SECTION I 


INTRODUCTION 


GENERAL 


The file system of the Series 600/6000 Comprehensive Operating 
Supervisor (the operating system) provides multiprocessor access to a 
common data base, full file protection, and highly selective access 
control. The file system allocates permanent file space and controls 
file access for users in all of the three modes of the operating system 
processing: 


a. local batch 

b. remote batch 

c. time-sharing 
From the programmer's viewpoint, the file system provides automatic 
management of permanent-file storage space. He can store files by name 
and retrieve them readily. The user accesses his files logically, 


without concern for the physical characteristics or constraints of the 
device on which the file is stored. 


Note that the file system does not itself provide facilities for reading 
or writing user's file content; see "File Space Versus File Content," 
below. 


In addition to facilitating basic file storage and retrieval, the file 
system provides other important features: 

a. hierarchical catalog/file structures 

b. selective access control 

c. security protection 

d. communication between local batch, remote batch, and 


time-sharing modes, via permanent files 


These features are optional in the sense that, if a given user does not 
need them, the file system allows him to proceed in a_e straightforward 
manner. He may, on the other hand, utilize the file system in as 
sophisticated a fashion as his needs require. 


1-1 BR38 


From the overall system viewpoint, the file system provides: 


a. a permanent on-line data base common to the local batch, remote 
batch, and time-sharing modes of operation 


b. efficient utilization of high-speed secondary storage space 


c. a convenient method of referencing files contained on removable 
media 


The common data base allows for a truly integrated 3-dimensional system, 
since the several processing modes not only co-exist, but can also 
interact with a common file. One application of this capability permits 
a large batch job to generate or update a file (perhaps based upon other 
files entered from time-sharing terminals) and have that file available 
for inquiry by time-sharing users. 


Another application allows a time-sharing user to generate a job for 
batch processing. The user's program may be too large to execute 
conveniently in the time-sharing mode, or may be an existing program for 
which modification for time-sharing execution is not desirable. 


The unified, efficient management of high-speed secondary storage (i.e., 
on-line shared-file devices) by the file system is essential to a 
multiprogramming, multiprocessing, and time-sharing environment, where 
such space is at a premium, 


FILE SPACE VERSUS FILE CONTENT 


The file system provides a straightforward means of defining physical 
file space for permanent files and controlling access to it; as such, it 
does not manage file content. Actual input/output is performed via the 
standard I/O facilities provided by the operating system and the File 
and Record Control facility routine. Thus, the phrase "creating a file" 
means the definition of a specific extent of space on a storage device, 
associated with a given file name and file creator, 


COMMUNICATING WITH THE FILE SYSTEM 


There are two modes of user communication with the file system. The 
local batch and remote batch user communicates via the FILSYS (file 
system) activity language, which is documented in this manual. The 
time-sharing user, at a remote terminal, communicates by means of the 
ACCESS subsystem, which is part of the Time-Sharing System. The use of 


ACCESS is described in Time-Sharing System General Information Manual. 
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ERROR MESSAGES 


Error messages that may be encountered during a FILSYS activity are 
listed in Appendix A. 


DECK SETUPS 


Appendices B and C illustrate sample deck setups for FILSYS activities. 


MERGE ACTIVITY PROGRAM 


The Merge Activity Program (MACT) is a means by which a privileged user 
may merge his saved perm files into one file containing the most recent 
contents of each saved perm file. MACT is not a FILSYS activity; it is a 
utility routine which may be used, at the user's discretion, in 
conjunction with FILSYS activities. MACT is described in Appendix E. 
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SECTION II 


ORGANIZATION OF THE FILE SYSTEM 


LOGICAL STRUCTURE 


The file system is, in formal terms, a tree structure whose origin is 
the system master catalog. The primary nodes of the tree are the user's 
highest level catalogs, referred to as the user's master catalogs. The 
lower-level nodes, if they exist, are subcatalogs. The terminal points 
of the structure are the files themselves. A schematic representation of 
the file system's hierarchical structure is shown in Figure 2-1. 


System Master Catalog 


The system master catalog (SMC) identifies by master catalog name each 
user known to the operating system. A log-on password and a user-id is 
associated with each master catalog name. Within the system master 
catalog are pointers to each user's master catalog (UMC) if one exists, 
and a record of each user's maximum file space allotment. Accounting 
information of the time-sharing system also is kept in the SMC. An _ SMC 
entry may not be created, modified, or listed except by personnel 
authorized to do so by the installation. Before using the file system, a 
user must have an SMC entry created for him. 


Note 


The term "catalog" should be understood to include UMC's’) and 
all lower level catalogs, and to exclude the SMC. The term 
"subcatalog" is used, where necessary, to exclude reference to 
UMC's as well. 


Note that the SMC provides user identification to the system and an 
entry is needed for each TSS user even if no permanent files exist for 
him. The UMC may be created automatically, when the first subcatalog or 
file is created, or by an explicit catalog create. 


Catalogs And Files 


A catalog consists of a definition containing the catalog name, and 
password and/or permissions, and pointers to any files or _ subcatalogs 
emanating directly from the catalog. A catalog as such cannot be read or 
written by a user since it contains no user data. 
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All SMC-entry names must be unique within the system; all subcatalog and 
file names are automatically qualified by the user's master catalog name 


and the names of any intermediate subcatalogs. The system master catalog 
cannot be accessed by the normal user. 


Figure 2-1. Logical Structure of the File System 


A file, as known to the file system, consists of a definition containing 
the file name, file size, and password and/or permissions, and a 
description of the physical file space. The file definition is distinct 
from the physical file space, which may contain user data and can be 
read or written by the user. 


Passwords 


A password can be attached to any catalog or file. A password simply 
allows a user to traverse a catalog/file string. A user can get to a 
given catalog or file only if he can give the passwords for all 
higher-level catalogs in the string. (When traversing a string, a 
password must not be given if none has been attached.) The originator of 
a given string is not exempt from giving the required passwords when 
traversing that string. 


Permissions 


Permissions, both general and specific (as to users), can be attached to 
any catalog or file. When permissions are attached at the catalog level, 
they apply to all subordinate catalogs and files. The originator of a 
catalog/file string implicitly has all permissions for that string, but 
must give all applicable passwords. The allowable permissions are as 
follows: 


General or Specific 


READ -- allows a file to be read 
WRITE -- allows a file to be written 
APEND -- presently treated as WRITE 
EXECUTE -- presently treated as READ 


Specific Only 


PURGE -- allows catalogs and/or files to be 
purged from the system 


MODIFY -=- allows catalog and/or file definitions 
to be changed 


Having been entered into the system as a valid user by the creation of 
an SMC entry via appropriate site operations, the user has only to 
create his own subcatalog structure, for the UMC will be created 
automatically, unless the user chooses to do so himself. If created 
automatically, it will contain no password and no permissions; i.e., 
anyone can pass through this level (by correctly naming the catalog) but 
gains no permission thereby. 
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IDENTIFYING A FILE 


File names, and catalog names as well, need not be unique in the file 
system, except that all files emanating directly from a given catalog 
must be uniquely named within the level at which they are defined. To 
uniquely identify an individual file in the system, a catalog/file name 
string is given, beginning with the creator's master catalog (UMC) name 
and ending with the file name. 


Each successive catalog name in the string qualifies the file name, 
thereby uniquely defining the file. This string is called the 
catalog/file description. The catalog/file description of any file or 
catalog must include the names of all of the higher-level catalogs that 
must be traversed in order to arrive at the desired point. (Any 
catalog/file description must include at least a UMC name.) 


FILE AND CATALOG PROTECTION 


The ability of a user to access files and to otherwise manipulate 
catalog/file structures (i.e., modify or purge) depends basically upon 
his knowing the necessary catalog/file descriptions. Beyond this, 
however, the file system provides an additional level of security 
protection -- passwords -- and selective access control -- permissions. 


Security Protection 


The creator of a catalog/file string can attach passwords at any point 
in his string, one password per catalog or file. The creator, or anyone 
else to whom he has given MODIFY permission, can modify, delete, or add 
passwords to an existent catalog/file string. The DUMP option will not 
be honored for unpriviledged FILSYS activities. This is a security 
Measure to prevent unauthorized disclosure of file system catalogs and 
passwords. 


Access Control 


Permission may be granted to other users, by the file creator, for one 
or more kinds of access to his files or catalogs. (Files can be read, 
written, appended to, executed, or purged. Catalogs and file definitions 
can be modified or purged.) Permissions provide a positive protection 
feature in that, if the creator does not explicitly grant them, his 
catalog and files are by default protected against access by others. He 
must, therefore, actively assign to others any degree of access he 
wishes them to have. (An exception to this exists for time-sharing 
users, where general read-permission is assigned by default when the 
file is created as a result of a SAVE command.) 
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Two classes of permission may be granted: (1) general - to all users 
known to the file system; and (2) specific - to specified users, by 
user-id. General READ, WRITE, APEND, an EXECUTE permissions can be 
granted. Specific permission may include these, as well as PURGE and 
MODIFY. (The special EXCLUDE "permission" -- specific only -- is 
discussed below.) 


Any combination of general permissions may be assigned at any catalog or 
file level (e.g., READ, APEND). As many specific permissions as_ are 
required may be assigned at any level. For instance, all of the 
following permissions could be specified in one catalog or one file 
definition: 


READ -- general read-permission 
APEND -- general append-permission 
READ/JDOE,BSMITH,FJONES/ -- specific read-permission 


for three named users 


WRITE/JDOE,BSMITH,FJONES/ -- specific write-permission 
for the same three users 


PURGE/BSMITH,FJONES/ -- specific purge-permission for 
two named users 


MODIFY/FJONES/ -- specific modify-permission for a 
single named user 


There is no limit on the number of user-id's that may be specified. 


Permissions are effective at and below the level at which they are 
granted. That is to say, a user accumulates permissions as he proceeds 
down a catalog/file string. However, he accumulates either general 
permissions or specific permissions, but not both. Since specific 
permissions for a given user do not add to, but replace, any general 
permission that may have been given, specific permissions may be used to 
exclude a given set of users from one or more types of access. The 
pseudo-permission EXCLUDE can be used to exclude a user or ae set of 
users from any general permissions. 


The MODIFY permission, which allows one user to change another's file 
names, catalog names, maximum file size, passwords, and/or permissions, 
also implies the ability to create catalogs and/or files emanating from 
that catalog at which the MODIFY permission is given. 


This permission should be granted with considerable caution, since if 
permissions or passwords are changed without the knowledge of the 
originator, he is still charged for the space though he may not be able 
to access the file(s). 
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SELECTION OF MEDIA 


Classes 


The file system allows the user to catalog files located on disk, drum, 
and magnetic tape media. Each type of media belongs to one of the 
following classes: 


Fixed Mass Storage - Media configured to the system at 
startup which will remain on-line for 
the life of the system (e.g., 
DSS270's; DSS200's; MDS200's; 
MSS800's; and DSS167, 170, and _ 180 
packs whose labels indicate "PERM" and 
which are mounted on "PERM" spindles 
at startup.) 


Structured Removable Media - Disk packs whose labels indicate 
"PERM" and which are mounted on 
spindles defined as "RMVBL" by 
startup. 


Nonstructured Removable Media - All magnetic tapes and any disk packs 
whose label indicates "RMVBL". (Such 
disk packs should be mounted on 
"RMVBL" spindles only.) 


When creating files and subcatalogs, the file systems uses media in the 
fixed mass storage class unless the user explicitly requests a device 
type or device name via the DEVICE option. Furthermore, unless’ the 
DEVICE option is present, the file system will automatically place any 
files or catalogs that emanate directly from the User Master Catalog 
(known as "level-1l" entries) on the fixed mass storage device with the 
largest amount of space available for files. This results in optimizing 
overall system performance. 


These automatic features have been included in the file system to 
obviate the use of the DEVICE option in normal file or catalog creation 
and its use is discouraged except in those cases where it is necessary 
(e.g., the file is on magnetic tape). 


Special Considerations 


Unusual situations may cause the user to be concerned about the physical 
location of his catalogs and files. Each class of media as defined above 
has a set of rules associated with it to control the allocation of file 
space and the creation of catalog/file structures. The rules are 
discussed here briefly to provide some guidance in these situations. 
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A. Fixed Mass Storage 


1. 


The total amount of file space on fixed mass_- storage 
currently reserved for a given user is limited by the 
allowable file size defined on the System Master Catalog 
entry for the user. When a file is created, a current size 
is defined for that file. If the file grows in size, the 
current size is updated to reflect the growth. The sum of 
the current size for all files under a System Master 
Catalog may not exceed allowable file size as specified by 
the System Master Catalog. 


The file content area always resides on the same device as 
the file description record. 


Level-1l entries may reside on any fixed mass_ storage 
device. 


Catalogs and files subordinate to a level-l entry must 
reside on the same device as the level-l. For example, if 
the catalog "PAYROLL" resides on device DS3, all catalogs 
and files subordinate to PAYROLL will reside on DS3. 


B. Structured Removable Media 


Ls 


The total amount of file space on any one structured 
removable pack for a given user is limited by the allowable 
file size defined in the pack master catalog entry for the 
user on the pack. When a file is created, a current size is 
defined for that file. If the file grows in size, the 
current size is updated to reflect that growth. The sum of 
the current size for all files under a master catalog may 
not exceed allowable file size specified by the master 
catalog. 


All catalogs and files which reside on structured removable 
media must emanate from a level-1l catalog; i.e., the user 
must create a level-1l catalog using the DEVICE option to 
specify the placement of the catalog on the structured 
removable pack and make any catalogs or files that are to 
reside on that pack subordinate to that level-l catalog. 
(More than one level-1l catalog may be used.) 


C. Nonstructured Removable Media 


1 


The amount of file space on nonstructured removable media 
is not limited or controlled by the file system. 


The file descriptions for files residing on nonstructured 
removable media must reside on fixed mass storage devices. 
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SECTION III 


USE OF THE FILE SYSTEM 


GENERAL 


Batch-dimension usage of the file system to create or modify catalog 
structures (either local or remote) requires use of the file-system 
processor which is engaged via the $ FILSYS control card, much in the 
same manner as the FORTRAN compiler is called via the $ FORTRAN control 
card. The file-system processor interprets all FILSYS-language 
instructions, known as "directives," until another $-control card is 
encountered. 


The format of the $ FILSYS control card is as follows: 


A 8 _16 
$ FILSYS dump option 
The FILSYS language consists of directives that collectively provide the 
facility for the following: 
@e creating catalogs and files 


@ purging catalogs and files 


@® modifying catalogs and file definitions (name, password, 
permissions, maximum size, etc.) 


e listing catalog/file structures 


e creating, modifying, and deleting system master catalog (SMC) 
entries 


@ saving and restoring SMC entries, catalogs, and files 


Once a permanent file has been created by means of a FILSYS activity, a 
batch user can identify and request this file for use in another 
activity with the $ PRMFL control card. This card is described in the 
Control Cards Reference Manual. Time-sharing modes of access to 
permanent files are described in the Time-Sharing System General 
Information Manual. 
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FILSYS DIRECTIVES 


Functions Of Directives 


The FILSYS directives and their functions are as follows: 


USERID -- identifies user to the file system 

CCREAT -- creates a catalog 

FCREAT -- creates a file 

CPOS -- positions user at a specified catalog level for 


subsequent operations 


CMOD -- modifies a catalog (name, password, and/or 
permissions) 
FMOD -- modifies a file definition (name, password, 


permissions, and/or maximum size) 


CPURGE -- purges (zeros and releases) a catalog/file string, 
starting at given catalog 


CRELES -~- releases a catalog/file string, starting at given 
catalog 

FPURGE -- purges a file, zeroing the space prior to release 

FRELES -- releases a file 

CLIST -- lists a catalog or catalog/file string 

CREL -- releases user from the previous catalog position 

SAVE -- saves a catalog or file 

RESTORE -- restores a catalog or file 

CRMAST -- creates a SMC entry 

MODMAS -- modifies a SMC entry 

RELMAS -- releases a SMC entry directives 

DELMAS -- deletes (i.e., purges) a SMC entry authorized 

MASLST -- lists the SMC by 

CRPACK -- creates a pack master catalog the 

MODPAC -- modifies a pack master catalog installation 

RELPAC -- releases a pack master catalog 

DELPAC -- deletes a pack master catalog 

SAVEMAST -- saves a master catalog 

RESTOREMAST -- restores a master catalog or file 


(ee) 
! 
iw 
od 
9) 
(es) 
oo 


Most of the directives require a catalog/file description as a variable 
field and allow options to be specified: SIZE, DEVICE, MODE, etc. The 
directives that affect the system and pack master catalogs are all 
protected against unauthorized use by special system controls. Use of 
one or more of these directives will cause the operator to be notified 
and FILSYS execution to be suspended until the user is verified as one 
authorized by the installation to maintain the master catalogs. If the 
user is not permitted to access the master catalogs, the activity will 
be aborted. 


Format Of Directives 


The general format of a FILSYS-language statement is: 
directivefvariable field 


The variable field is separated from the directive by at least one 
blank. (The CREL directive is the only directive that takes no variable 
field.) 


The directive statement can begin anywhere on the punched card. A 
variable field may be continued from one card to another by ending with 
a valid delimiter anywhere on the first card. The variable field is 
terminated by a blank immediately following a non-comma character. 


A comment card may appear anywhere in a FILSYS-activity source deck. An 
asterisk in column 1 indicates a comment card. 


The general format of the variable field is: 


catalog-string 
,option,....,option 
catalog/file-string 


Options must be separated by commas, as shown. No embedded blanks are 
allowed except immediately following a comma-separator. 


The variable-field format applies to all directives except those 
requiring a SMC name. The options may appear in any order, but must be 
preceded by the catalog-string or catalog/file-string description. 
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The general format of a catalog-string is: 
catalog$password/.../catalog$password/catalog$password 


The minimum required portion of this item is underlined. A password is 
given only if a catalog name refers to an already existent catalog to 
which a password is attached. The password is concatenated to the 
catalog name by a dollar sign ($). Every catalog named within the 
string, with perhaps the exception of the last one, must have’ been 
previously created. The final (or only) catalog name in the string may 
or may not refer to an already existent catalog, depending upon the 
nature of the directive (e.g., CCREAT vs. CPURGE). If two or more 
catalog names are given, they must be separated by a slant (/). 


Examples: 


(1) cat-l$passl/cat-2/cat-3 


(2) cat-1 
The general format of a catalog/file--string is: 


catalog$password/.../catalog$password/file$password 


The minimum required portion of this item is underlined. A password is 
given only if a catalog/file name refers to a catalog or already 
existent file to which a password is attached. The password is 
concatenated to the catalog or file name by a dollar sign ($). The file 
name may or may not refer to an already existent file, depending upon 
the nature of the directive (e.g., FCREAT vs. FPURGE). All catalog names 
must be separated from each other and from the file name by a= slant 


(/). 


A special directive, CPOS -- position to catalog -- is provided for the 
user's convenience in writing catalog-string and catalog/file-string 
descriptions. When the user is to perform a series of operations 
(create, modify, purge, etc.) at or below the level of a particular 
catalog, he may save himself the trouble of writing a repetitive series 
of complete string descriptions for a number of directives by first 
using a CPOS directive. In the CPOS directive, he specifies the common 


higher-level portion of the catalog string, and in subsequent 
directives, only the lowest-level portion of the string, down to the 
working level. Refer to "CPOS -- Position to Catalog", below, for a 


detailed description of CPOS operation. 
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Option Descriptions 


Each variable-field option is identified by a keyword. The options are: 


@ PASSWORD/password/ 


This option is used to assign a password to a catalog or file, or to 
replace an already assigned password with another. (A special form of 
this option is described under the CMOD and FMOD directive 
descriptions.) 


e General permission options: 
READ 
WRITE 
APEND 


EXECUTE 


e Specific permission options: 
permission-name/user-id,...,user-id/ 


where permission-name is READ, WRITE, APEND, EXECUTE, PURGE or 
MODIFY, or the pseudo-permission EXCLUDE. 


Both the general permission and the specific permission options are 
used to assign one or more permissions to a file, or to replace one 
or more already assigned permissions. The pseudo-permission EXCLUDE 
is used to exclude the named user(s) from any general permissions. As 
Many permission options as needed may be specified in one statement. 
The combined use of both specific and general permissions may produce 
an implicit exclude for the user identified in the specific 
permissions. 


BLOCKS 
LINKS 
e (SIZE /X1y/ 


Variable x is the initial size of the file to be created, in links or 
320-word blocks, and variable y is the maximum size to which the file 
may grow, in links or blocks. Both x and y are expressed as decimal 
integers, one to six digits in length. LINKS and SIZE are synonymous. 
Initial size(x) may not exceed maximum size(y). When creating a_ file 
that will reside on a MSS800 device, use of the BLOCKS option will 
result in x and y being rounded to the nearest multiple of 12. This 
rounding results from the fact that space on a MSS800 is allocated in 
links only. 
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type 
@ DEVICE/ name / -- form 1 


@ DEVICE/ removable type, file serial number / -- form 2 


Allowable type variables - DSS270, DSS200, MDS200, DSS167, DSS170, 
DSS180, DSS181, MSS800 


Allowable name variables - Any device names assigned to fixed mass 
storage devices by the installation 
(e.g., DS1, DP3) 


Allowable removable type variables - TAPE, TAPE7, TAPE9, 167PK, 
170PK, 180PK, 181PK 


Allowable file serial number variables - Any combination of 1 to 5 
characters from the 
character set used for 
identifiers. This field 
will appear as the file 
serial number in "GET" 
and "MNT" messages 
whenever this file or 
catalog name is 
referenced in a $ PRMFL 
card. 


Form 1 of the DEVICE option is used only when creating a catalog 
or file that emanates directly from the User Master Catalog (known 
as a "level-1" entry). It should be used only when it is essential 
that the level-l entry be located on a particular device or any 
device of a particular type (see "Selection Of Media" in Section 
2). 


Form 2 of the DEVICE option must be used when creating a level-l 
catalog which is to reside on a structured removable pack or when 
creating a file whose content resides on nonstructured removable 
media. When creating a level-1l catalog for a structured removable 
pack, the removable type variables "TAPE", TAPE7", and "TAPE9" are 
not allowed. When creating a nonstructured file, the FILEINFO 
option must also be present. 


Form 2 of the DEVICE option is used with the CRPACK, MODPAC, 


DELPAC, and RELPAC directives to uniquely identify the desired 
pack. 


RAND 
e@ MODE/ SEQ i 
This option is used to indicate that the file to be created will be 
treated as a random file (RAND), or as a sequential (i.e., linked) 
file (SEQ). If the mode-option is not specified, SEQ is assumed 
unless the directive is FCREAT/IDS/, in which MODE is forced to RAND. 
@e NEWNAM/catalog name or file name/ 


This option is used to replace a catalog or file name. 
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user-id,...,user-id 
DELETE/ GEN'L / 


This option is used to delete either specific permissions, by 
user-id, or all general permissions (GEN'L) from a catalog or file. 


ALL 
LISTOPT/4 ONLY? / 


This option is used to control the listing of catalog/file structures 
in directive statements other than SAVE, SAVEMAST, RESTORE, and 
RESTOREMAST. In the case of a SAVE, SAVEMAST, RESTORE or RESTOREMAST 
directive statement, the format of the option is 


YES 
LISTOPT/ 4 NO ?/. 


mmddyy 
DATE/<( TODAY } / 
This option is used to indicate that the specified directive be 
performed only for those permanent files which were written upon on 
date specified. The date is expressed by means of six digits. The 
character string TODAY in place of an explicit date causes’ the 
current system day to be used. 


SINCE/ mmddyy / 


This option is used to indicate that specified file directive be 
performed only for those permanent files which were written upon 
Since the date specified. Date is written by means of six digits. 


TIME/ ( hhmmm ) / 

{ se 

hh:mm 

This option is used to indicate that the specified directive be 
performed only for those permanent files written upon Since or after 
the time specified. Time is written according to a 24-hour clock 
where hh is the hour, mm reflects minutes in hundredths if no _ colon 
is used or minutes past the hour if a colon is used, and mmm reflects 
minutes in thousandths. This option must be used in conjunction with 
the DATE or SINCE option; the use of the TIME option alone is 
invalid. 


RESOURCES/nnnnnn/ 
This option is used to assign or modify the amount of a user's 
resources, in even dollars, for time-sharing system usage. The amount 


is expressed as a decimal integer, one to six digits in length. 
(Used in SMC directives only.) 
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YES 
COMPARE/ «NO ?/ 


This option is used in conjunction with the COPY option for SAVE and 
SAVEMAST directives. The option directs FILSYS to compare the data 
written in both saved files to ensure that the files contain 
identical data. If the copied data is incorrect, the save is 
restarted after an appropriate error message is printed. Note the 
COMPARE /YES/ is only valid when COPY/ YES/ has been specified. 


FILEINFO/file name { , XXX?tyyy {: XXX? YVY { wxxzyvy } } VV 


XXX first link number of string 
VYY number of links in the string 


The FILEINFO option is used if, and only if, the DEVICE option on a 
FCREAT directive specifies that a nonstructured file is to be 
created. The FILEINFO option defines the file name attached to the 
removable media and, if the media is a disk pack, allows definition 
of up to three discrete link strings comprising the file. If no link 
strings are defined and the media is a disk pack, the following 
values are assumed: 


Media Type First Link Number Of Links 
167PK 0 666 
170PK 0 1200 
180PK 0 1200 


Note: When the file is accessed by a user, the entire pack is 
allocated. The link strings defined at file create time have 
no affect on allocation and are for information only. 


File name may consist of from 1-12 characters from the character set 
used for identifiers. 


YES 
LODX/ (35"} Ve 


These options are used with the 
CRMAST and MODMAS directives to 


YES allow a user to invoke the 
CARDIN/ NO re related subsystems ain 
time-sharing. 
YES 
TALK/ NO / Le not specified, the NO 


variable is assumed. 


YES 
LODS (or LODSS) / NO / 


nn 
URGENCY /)NO{/ 


This option is used with the CRMAST and MODMAS directives to define 
an urgency value for CARDIN jobs run by the user. The allowable range 
of nn is defined as: 0s nn s 40. NO is the default value of the 
variable, implying normal urgency of 05 for CARDIN jobs. 
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RESET/ BUSY-FILE , IDS-ABORT ye 
{ BUSY-FILE } 
IDS-ABORT 
This option is used in conjunction with the FMOD directive to reset 
information in file description records. The BUSY=-FILE variable will 
cause the "number of readers", "number of writers", "file is being 
appended," "file is busy recovery", and "file is busy" private fields 
to be cleared. The IDS-ABORT variable will reset the "I-D-S file in 
abort status" indicator. 


The RESET option is protected against unauthorized use. The option is 
to be used only when it is certain that the status indicators are 
incorrectly set and that no user is currently accessing the file. 


DONTDO/ SMC-name,.../ 
DOONLY/ SMC-name,.../ 


i N 


This option is used in conjunction with SAVEMAST and RESTOREMAST 
directives to bypass or do only specified SMC-names. The option is 
also used with the RESTORE directive to bypass or do only specified 
catalog and/or files entries in a catalog. 


name-n name-m 
FROM/ / #n / THRU// #m / 


name=-n xxX*XEOF 
#n **K*XEOF 


This option is used in conjunction with SAVEMAST directive for saving 
the specified "section" of permanent files; names or numbers may be 
used to indicate the range. Refer to the description of the SAVEMAST 
directive for details. 


YES 
COPY/ NO f 


This option is used in conjunction with SAVE, SAVEMAST, RESTORE and 
RESTOREMAST directives. When used with the SAVE or SAVEMAST directive 
the COPY/YES/ will direct FILSYS to produce a copy of the save file 
while the save file is being created. The copy file is defined by a 
$ TAPE XS,... control card when producing the save file. If the copy 
option is YES and no $ TAPE XS,... control card exists, FILSYS will 
attempt to do a GEMORE for the magnetic tape handler. 


If write errors are encountered while producing the save file(s), 
FILSYS will notify the operator which of the units contained the 
errors and that the save will be restored. The operator can then take 
corrective action by changing both the magnetic tape handler and the 
tape reel on which the error occurred. 


When used with a RESTORE or RESTOREMAST directive, the COPY/YES/ 
indicates that a copy of the save file exists. If read errors are 
encountered during the restore, FILSYS will ask the console operator 
for the reel number of a duplicate save tape. If no $ TAPE XR,... 
control card exists, FILSYS will do a GEMORE for the magnetic tape 
handler. 
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CONCURRENT 
@ ACCESS/ NORMAL 7. 
MULTIPLE WRITE 
READ WHILE WRITE 


This option is used in conjunction with FCREAT and FMOD directives to 
specify an "access" mode at the time a file is created or is being 
modified. Absence of the ACCESS option when the FCREAT directive is 
used implies NORMAL. 


The following table illustrates the interaction of "access" mode and 
current status of file usage to determine the response of a request to 
access a file with either "read" or "write" permission. The assumption 
is made that the user requesting access has either general or specific 
read and write permission on the file. YES indicates the access request 
will be allowed; NO indicates denial. Refer to the File System SMD for a 
complete description of file accessing rules. 


Status of Access mode specified in FCREAT or FMOD 

file usage 

at time NORMAL MULTIPLE READ WHILE CONCURRENT 
access (null) WRITE WRITE 

request is 

received Permission requested at access time 


YES YES 
YES YES 
YES YES 


Character Set For Identifiers 


BUSY READ 
BUSY WRITE 


NOT BUSY 


The identifiers in a FILSYS statement (i.e., catalog/file names, 
passwords, and user-id's) may be from 1 to 12 characters in length, and 
may be composed of alphanumerics, minus signs, and periods. 


Directive Descriptions 


A detailed description of each directive follows. The minimum required 
portion of the variable field is underlined in each case. Mutually 
exclusive options are bracketed. (See Appendix D for a listing of 
directives, their variable fields, and options.) 


USERID -- IDENTIFY USER 


Once a user has an entry in the SMC, he is free to use the catal 
file space allotted to him. He must, however, identify himself 
legitimate user by means of the USERID directive. The format o 
directive differs from the general format. (This directive 
required for authorized users of SMC directives.) 
Note 
The user should not confuse this directive with the 


$ USERID control card. The use of a $ in conjunction with 
the directive will invalidate the directive. 


Format 


USERID master-catalog-name$log-on password 


Options 


None 


Rules 


og and 

as a 
£ this 
is not 


1. This directive must be the first one given in a FILSYS activity 
unless the purpose of the activity is to create the 


system-master-catalog. 
2. The log-on password is the one associated with the SMC 
and is distinct from the password that may be attached 


corresponding UMC. This is the only directive in whi 
log-on password is given. 


Examples 
(1) USERID ABCCORPS$584031 


ABCCORP is a master catalog name identifying an SMC 
584031 is the log-on password associated with this entry 


-—_— 
No 
~ 


USERID JPJONESSBHR 


Here the master catalog name is JPJONES and BHR is’ the 
password. 


(3) USERID CLASSO21SJAN15 


The master catalog name is CLASS021 and JAN15 is’ the 
password. 


entry, 
to the 
ch the 


entry. 


log-on 


log-on 


BR38 


CCREAT -- CREATE CATALOG 


The create-catalog directive is used to create a UMC or any level of 
subcatalog. A password and permissions may be attached to the catalog. 


Format 


CCREAT catalog-string,options 


Options 


PASSWORD, permissions, DEVICE 


Rules 


(2) 


The final or only name in the catalog-string description is the 
name of the catalog to be created. 


A catalog-string description containing only one name indicates 
explicit creation of the UMC (unless a CPOS directive has been 
given). 


If DEVICE specifies a structured removable device (i.e., a 
"level-1" catalog is to be created on a removable pack), that 
pack must be on-line if any other options are specified. 


If the new catalog is subordinate to a "level-1" catalog 
residing on a structured removable pack, that pack must be 
on-line, 


CCREAT ABCCORP,PASSWORD/XYZABC/,READ, 
READ/JDOE , WRITE/JDOE/ 


ABCCORP is the UMC name, corresponding to the SMC entry 
ABCCORP. This UMC is created with the password XYZABC, general 
read-permission, and specific read- and write-permissions for 
user JDOE. 


CCREAT JPJONES/CAT1 
JPJONES is the UMC name; CAT1 is the first-level subcatalog to 


be created. No passwords have been assigned so far and no 
access permission is granted at CAT1 level. 
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(3) 


CCREAT PAYROLL/PAYMASTER, DEVICE/167PK ,D352/, PASSWORD/1662/ 


PAYROLL is the UMC name; PAYMASTER is a "level-1" subcatalog to 
be created on structured removable DSS167 pack identified as 
D352. Since a password is to be attached to the catalog, pack 
D352 must be on-line for the catalog create to be successfully 
completed. 
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FCREAT -- CREATE FILE 


The create-file directive is used to define file space by name. An 
initial and maximum file size may be specified, a password and 
permissions may be assigned, and a device or device type may be 
specified. Random or sequential file treatment may be specified. 


Format 


FCREAT catalog/file-string,options 
Options 


PASSWORD; permissions; DEVICE; MODE; ACCESS; BLOCKS, LINKS, or SIZE 


Rules 


1. If the UMC does not already exist, a catalog/file description 
consisting of UMC-name/filename will cause the UMC to be 
created automatically (no password or permissions attached), as 
well as the named file. 


2. If the SIZE option is not given, a l-link file is created. 


3. Random files may lose integrity after a SAVE directive and 
subsequent RESTORE directive are utilized for files wherein the 
physical block size of the device on which the files are saved 
differs from the block size on which they are restored. This 
problem may be circumvented by use of the "DEVICE type" option 
of FCREAT. 


4. If the new file is subordinate to a "level-1" catalog residing 
on a structured removable pack, that pack must be on-line. 


(1) FCREAT CLASS021/PROBLINPUT, READ 


CLASSO021 is the UMC name; PROBIINPUT is the name of the file to 
be created, emanating directly from the UMC. The file is 1 
link long, with general read-permission granted. No passwords 
are attached to the string. 
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(2) FCREAT JPJONES/CAT1/FILE01.1,SIZE/2,5/ 


Here file FILE0O1.1 emanates from the subcatalog CAT1. Initial 
size is 2 links, maximum size is 5 links. No access permissions 
are granted at the file level. 


(3) FCREAT J.P.JONES/CAT1/FILEO1.2,DEVICE/170PK,P0883/, 
FILEINFO/FILE2,366:40/ 


File FILE01.2 emanates from the subcatalog CAT1. The file 
content is located on a nonstructured DSS170 pack identified as 
P0883. The file name is FILE2 and the file occupies 40 links 
beginning at 366. 


To accommodate I-D-S, the FCREAT directive is used as follows: 


FCREAT/IDS/ 


The options listed above for FCREAT are applicable with additional 
options added for I-D-S: 


Option Range of n Default Value 
BASESIZE/n/ l< ns 262143 (required field) 
RNG/ny ,n9/ 1s n,s 262143 (required field) 


1s nos 262143 


PAGESIZE/n/ 40 < n < 640 320 (decimal) 
LINESPERPAGE/n/ lsn<«< 63 63 (decimal) 
INVENTORY /n/ ls n < 100 75 (BCD) 

or 

NO 


MULTIUSER/ YES rs 
NO 


The YES variable specifies that I-D-S multi-access protection is 
to be invoked when this file is accessed. The default variable is 
NO. 
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CPOS -- POSITION TO CATALOG 


The position-to-catalog directive is used to specify a catalog level for 
subsequent operations. A string of existent catalogs is specified; the 
effect is to cause the catalog or file name in subsequent directives to 
be concatenated to the specified catalog string. 


Thus, if several catalog/file creations, modifications, or purges are to 
be performed at the same level, repeated descriptions of higher level 
catalogs may be avoided by the use of CPOS. The effect of a CPOS 
directive is nullified by a subsequent CPOS or CREL (release from 
catalog position) directive. 


Format 


CPOS catalog-string 


Options 


None 


Rules 


1. The CPOS directive affects the operation of the following 
directives: CCREAT, FCREAT, CPURGE, FPURGE, CMOD, FMOD, CLIST, 
CRELES, FRELES. 


2. Once a catalog position has been established, it remains in 
effect until another CPOS or a CREL is encountered. 


(1) CPOS JPJONES/CAT1 


JPJONES is the UMC name; CAT1 is a catalog emanating directly 
from it. 


(2) CPOS ABCCORPSXYZABC 


ABCCORP is the UMC name; XYZABC is the password attached to 
this catalog. 


CMOD -- MODIFY CATALOG 


The modify-catalog directive is used to modify the name, password, 
and/or permissions of an existent catalog. 


Format 


CMOD 


Options 


catalog-string, option,...,option 


NEWNAM, PASSWORD, permissions, DELETE 


Rules 


1. 


4. 


Examples 


(1) 


The final or only name in the catalog-string description is the 
name of the catalog to be modified. If this catalog resides on 
a structured removable pack, that pack must be on-line. 


If the PASSWORD option is given without a following 
slant-enclosed identifier, the existing password is deleted. 


If one or more general permissions are specified, the set of 
already assigned general permissions, if any, is replaced (not 
added to); if one or more sets of specific permissions are 
specified, any corresponding set(s) of already assigned 
specific permissions, by named user, are replaced (not added 
to). 


The UMC name may not be modified. 


CMOD ABCCORP$XYZABC,PASSWORD/ZYXCBA/, READ,WRITE,READ/RFOX/, 
WRITE/RFOX/ , PURGE/RFOX/ , EXCLUDE/JDOE/ 


ABCCORP is the name of the catalog to be modified; XYZABC is 
the password assigned to it. The password is replaced by 
ZYXCBA. The original set of general permissions (READ) is 
replaced by READ and WRITE. The set of specific permissions 
READ, WRITE, and PURGE for user RFOX is added, effectively 
(none originally assigned for this user). User JDOE is excluded 


from any permissions. (The previously assigned set of specific 
permissions for JDOE (READ and WRITE) is replaced by EXCLUDE. 
User JDOE has presumably been fired.) (See CCREAT, Example 1.) 
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(2) 


CMOD JPJONES/CAT1,NEWNAM/STORES/, 
PASSWORD/BNHMRCHD/ , READ 


JPJONES/CAT1 is the catalog string description; CAT1l is the 
catalog to be modified. The catalog name is replaced (NEWNAM) 
by STORES. The password BNHMRCHD is added, effectively (none 
originally assigned), and general read-permission is granted. 
(See CCREAT, Example 2.) 
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FMOD -- MODIFY FILE 


The modify-file directive is used to modify the name, password, 
permissions, and/or maximum size of a file. Mode and device may not be 
changed. In addition, any of the special options for I-D-S files may be 
used if the file is an I-D-S file. (Refer to the FCREAT directive for 
FCREAT/IDS/.) 


Format 


FMOD catalog/file-string, option,...,option 


Options 


NEWNAM, PASSWORD, permissions, DELETE, size, ACCESS, RESET 
I-D-S only:BASESIZE,RNG,PAGESIZE,LINESPERPAGE , INVENTORY ,MULTIUSER 


Rules 


1. The format of the size option for this directive is: BLOCKS or 
SIZE or LINKS /y/, where y specifies the new maximum size of 
the file. 


2. The final or only name in the catalog file-string is the name 
of the file to be modified. If the file resides on a structured 
removable pack, that pack must be on-line. 


(1) FMOD CLASS021/PROBLINPUT ,NEWNAM/BINSRCHDATA/, 
MODIFY/RFOX 


CLASSO21/PROB1INPUT is the catalog/file-string description; 
PROBLINPUT is the file to be modified. The file is renamed 
BINSRCHDATA and MODIFY permission for RFOX is added. 


(2) FMOD JPJONES/STORESSBNHMRCHD/FILE01.1/,SIZE/4/, 
READ , PASSWORD/BOSN/ 


JPJONES/STORESSBNHMRCH/FILEO1.1 is the catalog/file 
description; FILEO1.1 is the file to be modified. The previous 
maximum size is changed to 4 links, general read-permission is 
granted, and the password BOSN is attached. 
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CPURGE -- PURGE CATALOG 


The purge-catalog directive is used to purge (i.e., remove from the file 
system) a specified catalog and any subcatalogs and/or files emanating 
from it. Space occupied by file content is zeroed prior to being 
released for system usage. 


Format 

CPURGE catalog-string 
Options 

None 
Rules 


1. The final or only name in the catalog-string description is the 
name of the catalog to be purged. If the catalog resides on a 
structured removable pack, that pack must be on-line. 


2. If the catalog to be purged is a UMC, any "level-1" subordinate 
catalogs that reside on structured removable packs (and any 
catalogs or files subordinate to them) will be left intact on 
those packs. To purge such catalogs (and their subordinates) 
use an individual CPURGE directive for each level-1 catalog. 


Example 


CPURGE UMCAT/CATI1SPASS1/CAT2$PASS2 


The catalog CAT2 and any catalogs and files subordinate to it 
are purged. 
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CRELES -- RELEASE CATALOG 


The release-catalog directive is used to remove from the file system a 
specified catalog and any subcatalogs and/or files emanating from it. 
Space occupied by file content is not altered prior to being released 
for further use. 


Format 


Options 


Rules 


Example 


CRELES catalog-string 


None 


The final or only name in the catalog-string description is the 
name of the catalog to be released for system usage. If the 
catalog resides on a structured removable pack, that pack must 
be on-line. 


If the catalog to be released is a UMC, any "level-1" 
subordinate catalogs that reside on structured removable packs 
(and any catalogs or file subordinate to them) will be left 
intact on those packs. To release such catalogs (and their 
subordinates) use an individual CRELES directive for each 
level=-1 catalog. 


CRELES UMCAT/CATI$SPASS1/CAT2$PASS2 


Catalog CAT2 and any catalogs and files subordinate to it are 
released for system usage. 
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FPURGE -- PURGE FILE 


The purge-file directive is used to purge a specified file from the file 
system. Space occupied by file content is zeroed prior to release for 
further system usage. 


Format 

FPURGE catalog/file-string 
Options 

None 
Rules 


1. If the file is a nonstructured file, file content space is not 
zeroed. 


2. If the file resides on a structured removable pack, that pack 
must be on-line. 


Example 


FPURGE UMCAT/CAT1SPASS1/FIL0O1.3SPASS01.3 


The file FILO1.3 is purged. 
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FRELES -- RELEASE FILE 


The release-file directive is used to remove from the file system 
content a specified file. The physical file space associated with the 
file name is not altered prior to being released for system usage. 


Format 
FRELES catalog/file-string 
Options 
None 
Rule 
If the file resides on a structured removable pack, that pack 
must be on-line. 
Example 


FRELES UMCAT/CATIS$PASS1/FIL1$PASS1 


The file FIL1 is released. 
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CLIST -- LIST CATALOG STRUCTURES 


The list-catalog-structure directive is used to obtain a listing of all 
or a portion of a user's catalog/file structure. The listing includes 
the following information for each catalog or file, as appropriate: 
originator, password, device, creation date, date of last modification, 
date of last access, permissions, maximum and current file size, and 
file type. 


The format of a catalog/file listing is described under "An Example of 
FILSYS-Activity Language Usage" in this section. 


Format 

CLIST catalog-string, LISTOPT-option 
Options 

LISTOPT/ALL/ or LISTOPT/ONLY/ 
Rules 


1. The final or only name in the catalog-string description is the 
name of the catalog at which the listing is to begin. 


2. If LISTOPT/ALL/ is specified, the name and contents of the 
named catalog and all subordinate catalogs and file definitions 
are listed. 


3. If LISTOPT/ONLY/ is specified, the name and contents of the 
named catalog and only those catalogs and file definitions 
immediately subordinate to it are listed. 


4. If the LISTOPT option is not specified, LISTOPT/ALL/ is 
assumed, 


5. Catalog and file descriptions that reside on removable media 
will be listed only if the final name in the catalog-string 
description resides on the removable media and if that media is 
currently on-line. However, references to removable media will 
be shown whenever they are encountered. 
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Examples 


(1) 


(2) 


(3) 


(4) 


CLIST UMCAT 


The complete catalog/file structure beginning with the 


UMCAT is listed. 


CLIST UMCAT, LISTOPT/ALL/ 
Equivalent to Example (1). 
CLIST UMCAT, LISTOPT/ONLY/ 


The catalog UMCAT and any 


CLIST UMCAT/CATISPASS1 


The complete catalog/file structure beginning with the 


CAT1 is listed. 


first-level 
emanating directly from it are listed. 


subcatalogs 


catalog 


files 


catalog 
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CREL -- RELEASE FROM CATALOG POSITION 


The release-from-catalog-position directive is used to cancel the effect 
of a previous CPOS directive. 


Format 

CREL 
Options 

None 
Rule 


This directive takes no variable field. 


2 
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SAVE -- SAVE CATALOG OR FILE 


The save-catalog-or-file directive is used to allow the "normal" user to 
save a specific catalog and the catalogs and files emanating from that 
catalog or to save a specific file on tape. 


Forma 


t 


YES YES YES 
SAVE catalog/file-string| ,LIsT0P7/ NO (/,COPY /\ NO / ,COMPARE/§ NO / 


Options 


YES 
LISTOPT/ {io 7 ,COPY , DATE, SINCE, TIME , COMPARE 


Rules 


The final or only name in the catalog/file-string description 
is the name of the catalog at which the saving is to begin, or 
of the file that is to be saved. 


To assign a tape to a program, the control card $ TAPE must be 
inserted into the deck as illustrated in Appendix C. 


If the COPY option is /YES/ then a $ TAPE XS,---control card 
should be inserted in the deck, as shown in Appendix C. 


Files modified by use of the FMOD directive and not written 
upon in the specified interval will not be saved when an 
attempt is made to save these files. That is, file modification 
by use of the FMOD directive only does not constitute 
sufficient activity to have a file saved. 


Catalog and files residing on structured removable packs will 
be saved only if the final name in the catalog/file-string 
resides on the removable pack and if that pack is currently 
on-line. However, sufficient information to restore the 
references to removable packs will be saved whenever it is 
encountered. 


The save process will have "PRIVATE" permission to the file 
while the file content is being saved. If the file is "busy", 
save processing will wait up to two minutes for the file to 
become available. If the file remains "busy", the file content 
and file description will not appear on the save tape. 


Files in "defective" status and files in "abort" status will 


not be saved. File contents for nonstructured files will not be 
saved. 
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Examples 


(1) SAVE CLASS021,LISTOPT/YES/ 
UMC CLASS021 and all subordinate catalogs and files are _ saved. 
The structure will be listed. 


(2) SAVE CLASS021/PROBLINPUT 
The file PROBLINPUT is saved. No list will be made. 


(3) SAVE CLASS021,COPY/NO/,LISTOPT/YES/ 
UMC CLASS021 and all subordinate catalogs and files are saved. 
No copy of the save file will be produced. The saved structure 
will be listed. 
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RESTORE -- RESTORE CATALOG OR FILE 


The restore-catalog-or-file directive is used to allow the "normal" user 
to restore a specific catalog and the catalogs and files emanating from 
that catalog or to restore a specific file from magnetic tape. The 
restored catalog/file structure may be listed, if desired. 


Format 


YES YES 
RESTORE catalog/file-string| ,LIsToPT/ NO (/,COPY/ (ey, 
DONTDO/name-n,...,name-m/ 
DOONLY/name-n,...,name-m/ 
Options 


YES 
LISTOPT/ {ie } /,COPY ,DATE,SINCE, TIME 
Rules 


1. The final or only name in the catalog/file-string description 
is the name of the catalog at which restoring is to begin, or 
of the file that is to be restored. 


2. To assign a "restore" tape to the FILSYS activity, the control 
card $ TAPE must be inserted into the deck as illustrated in 
Appendix C. The file-code is PR for a restore operation. 


3. To assign the copy of the "restore" tape, if one exists, the 
$ TAPE XR,...control card should be used as shown in Appendix 
Cs 


4. To restore to removable media, that media must be on-line. 


5. The restore process will have "PRIVATE" permission to the file 
while the file content is being restored. 


6. If the DOONLY/DONTDO option is used, the final or only name in 


the catalog/file-string description must be that of a catalog 
description. 
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Examples 


(1) 


(2) 


(3) 


(4A) 


(4B) 


RESTORE CLASS021,LISTOPT/YES/ 
UMC CLASSO21 and all subordinate catalogs and files is 
restored. The structure will be listed. 


RESTORE CLASS021/PROBLINPUT 
The file PROB1LINPUT is restored. No list is prepared. 


RESTORE CLASS021,COPY/YES/,LISTOPT/YES/ 

UMC CLASSO21 and all subordinate catalogs and files is 
restored. If a magnetic tape read error is encountered FILSYS 
will ask the operator for the reel number of the copy of the 
same file. FILSYS will then use the copy file to continue the 
restore function. 


RESTORE CLASS021,DONTDO/FILEA,CATONE/ 

All catalogs and files subordinate to CLASSO21, with the 
exception of FILEA and CATONE, will be restored. No list is 
prepared. 


RESTORE CLASS021,DOONLY/FILEA,CATONE/ 

Only the entries subordinate to CLASS021, FILEA and CATONE, 
will be restored. If the DOONLY name is a catalog entry, all 
catalogs or files subordinate to the DOONLY name will be 
restored. 
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CRMAST -- CREATE SMC ENTRY 


The create-SMC-entry directive is used to create a user's entry in the 
SMC. This directive is protected against unauthorized use. 


Format 


CRMAST master-catalog-name/user~id,options 


Options 


Required: PASSWORD (log-on); BLOCKS,LINKS,or SIZE 
Optional: RESOURCES,LODX,CARDIN,TALK,LODS (or LODSS) , URGENCY 


Rules 


1. In the item BLOCKS or SIZE or LINKS /y/, y specifies the 
maximum number of Jlinks/blocks of file space that may be 
created on fixed mass storage under the SMC entry. y is 
expressed as a decimal integer from one to six digits in 
length. 


2. RESOURCES is used to specify the even-dollar amount of 


time-sharing-usage resources assigned to the user. The amount 
is specified as a 1l- to 6-digit decimal integer. 


(1) CRMAST ABCCORP/ABCCORP, PASSWORD/584031/, SIZE/20/ 


(2) CRMAST JPJONES/JPJONES, PASSWORD/BHR/, SIZE/8/, 
RESOURCES/500/ 
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MODMAS -- MODIFY SMC ENTRY 


The modify-SMC-entry directive is used to replace the log-on password, 
file-space allotment, and/or dollar resources in a user's entry in the 
SMC. This directive is protected against unauthorized use. 


Format 


MODMAS master-catalog-name/user-id,option,...,option 


Options 


PASSWORD; BLOCKS,LINKS or SIZE; RESOURCES; LODX; CARDIN; TALK; LODS 
(or LODSS); URGENCY 


Rules 


1. At least one option must be specified in this directive. 


2. The format of the RESOURCES and the BLOCKS, LINKS, or SIZE 
option for this directive are as described for CRMAST, 


3. The option values replace (i.e., do not add to) the original or 
current values in the SMC. 


(1) MODMAS ABCCORP/ABCCORP, SIZE/30/ 


(2) MODMAS JPJONES/JPJONES, PASSWORD/1792/, 
RESOURCES/500/ 


Ww 
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RELMAS -- RELEASE SMC ENTRY 


The release-SMC-entry directive is used to release a user's entry from 
the SMC. The complete catalog/file structure emanating from that entry 
(except that on a structured removable pack) is purged. This directive 
is protected against unauthorized use. Space occupied by file content is 
not altered prior to being released for system usage. 


Format 


RELMAS master-catalog-name/user-id 


or 


RELMAS master~catalog-name 
Options 
None 


Examples 


(1) REMLAS CLASS021/CLASS021 


(2) RELMAS CLASS021 


3-33 BR38 


DELMAS -- DELETE SMC ENTRY 


The delete-SMC-entry directive is used to delete a user's entry from the 


SMC. The complete catalog/file 


Format 


DELMAS master-catalog-name/user-id 


or 


DELMAS master-catalog-name 
Options 


None 


Examples 


(1) DELMAS CLASS021/CLASS021 


(2) DELMAS CLASS021 


structure 
(except that on a structured removable pack) is purged. 
by file content is zeroed prior to being released for further usage. 


emanating from that 


entry 
occupied 
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MASLST -- MASTER LIST 


The master-list directive can be used in four ways: 


To obtain a listing of the SMC (i.e., the contents of each SMC 
entry (ONLY). 


To obtain a listing of each SMC entry and the catalog/file 
structure emanating from each (ALL). 


To obtain a listing of a specific SMC entry (ONLY). 


To obtain a listing of a specific SMC entry and its subordinate 
catalog/file structure (ALL). 


This directive is protected against unauthorized use. 


Format 


(1) 
(2) 


Options 


Rules 


MASLST LISTOPT-option 
MASLST master-catalog-name, LISTOPT-option 


LISTOPT/ALL/ or LISTOPT/ONLY/ 


In form (1), if LISTOPT/ONLY/ is specified, only the contents 
of each SMC entry is listed. 


In form (1), if LISTOPT/ALL/ is specified, the contents of each 
SMC entry and all subordinate information is listed. 


In form (2), if LISTOPT/ONLY/ is specified, only the contents 
of the named SMC entry is listed. 


In form (2), if LISTOPT/ALL/ is specified, the contents of the 
named SMC entry and all information subordinate to it are 
listed. 
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In form (2), if the LISTOPT-option is not specified, 
LISTOPT/ALL/ is assumed, 


Catalog/file structures residing on removable media will not be 


listed. However, references to removable media will be shown 
whenever they are encountered. 


MASLST LISTOPT/ONLY/ 
MASLST JPJONES, LISTOPT/ONLY/ 


MASLST JPJONES 
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CRPACK -- CREATE PACK MASTER CATALOG ENTRY 


The create-pack-master-catalog-entry directive is used to create a 
user's entry in the device-master-catalog contained on a _e structured 
removable pack. This authorizes the file system to allow files and 
catalogs to be created on the pack under that master-catalog name. This 
directive is protected against unauthorized use. 


Format 


CRPACK master-catalog-name, options 


Options 


Required: DEVICE; BLOCKS, LINKS, or SIZE 
Rules 


1. In the item BLOCKS, LINKS, or SIZE /y/,y specifies the maximum 
number of links/blocks of file space that may be created on the 
pack specified under the master-catalog name specified. 

2. The master-catalog-name specified need not be currently entered 
in the SMC. However, before any catalogs or files can be 
created on the pack the master-catalog-name must be entered in 
the SMC via a CRMAST directive. 


3. Form 2 of the DEVICE option must be used to specify the pack 
type and file serial number. 


4. The pack specified must be on-line. 


Example 


CRPACK ABCCORP,DEVICE/167PK,D352/,LINKS/50/ 
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MODPAC -- MODIFY PACK MASTER CATALOG ENTRY 


The modify-pack-master-catalog entry directive is used to replace 
file-space allotment in a user's entry in a pack master catalog. 
directive is protected against unauthorized use. 


Format 


MODPAC master-catalog-name, option 


Options 


Required: DEVICE 
Optional: BLOCKS, LINKS, OR SIZE 


Rules 


1. The master-catalog-name referenced must be present on the 
specified. The pack must be on-line. 


2. The value given for BLOCKS, LINKS, or SIZE will replace 


the 
The 


pack 


the 


current value in the pack's device-master-catalog entry for the 


specified user. 


3. Form 2 of the DEVICE option must be used to specify the 
type and file serial number. 


Example 


MODPAC ABCCORP, DEVICE/167PK,D352/,SIZE/75/ 


pack 
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RELPAC -- RELEASE PACK MASTER CATALOG ENTRY 


The release pack-master-catalog-entry directive is used to release a 
user's entry from a pack's device master catalog. All catalog/file 
structure on the pack under the master catalog name specified is 
released. This directive is protected against unauthorized use. Space 
occupiea by file content is not altered prior to being released for 
system usage. 


Format 


RELPAC master-catalog-name, option 


Option 


Required: DEVICE 


Rules 


1. Form 2 of the DEVICE option must be used to specify the pack 
type and file serial number. The pack must be on-line. 


2. The master-catalog-name must be present in the SMC. 

3. All Jlevel-1 catalogs (resident on the _ pack) under the 
master-catalog-name specified must emanate from the 
user-master-catalog related to the SMC entry having the same 


master-catalog-name. Failure to observe this rule may result in 
file space not being returned to the system. 


Examples 
RELPAC ABCCORP, DEVICE/167PK,D352/ 
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DELPAC -- DELETE PACK MASTER CATALOG ENTRY 


The delete-pack-master-catalog-entry directive is used to delete a 
user's entry from a pack's device master catalog. All catalog/file 
structure on the pack under the master catalog name specified is 
released. This directive is protected against unauthorized use. Space 
occupied by file content is zeroed prior to being released for further 
use. 


Format 


DELPAC master-catalog-name, option 


Option 
Required: DEVICE 
Rules 
1. Form 2 of the DEVICE option must be used to specify the pack 
type and file serial number. The pack must be on-line. 
2. The master-catalog-name must be present in the SMC. 
3. All level-1 catalogs resident on the pack under the master 
catalog name specified must emanate from the user master 
catalog related to the SMC entry having the same master catalog 


name. Failure to observe this rule may result in file space not 
being returned to the system. 


Examples 


DELPAC ABCCORP, DEVICE/167PK,D352/ 
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SAVEMAST -- SAVE MASTER CATALOG 


The save-master-catalog directive is used to allow the "privileged" user 
to save the entire contents of SMC entries and their subordinate 
catalogs and files; or to allow the "privileged" user to save a specific 
SMC entry and its subordinate catalogs and files. Device master catalogs 
on removable media are not saved. 


Format 


The SAVEMAST directive has the following forms: 


YES 
(1) SAVEMAST LISTOPT/ (NO ?/ 


(2) SAVEMAST name=-n YES 
DONTDO/name-n,...,name-m [ -LISTOPT/ NO / | 


name-n name-m 
(3) SAVEMAST FROM// #n /THRU// #m / 
#name-n xKKEOF 
~~ 


#n FEEEOFE. 


YES YES 
(4) SAVEMAST COPY/ No" }/,nass0n0/ees/, conoase/{ $0 / 


Options 


YES 
LISTOPT/ {8 } / ,DONTDO ,DOONLY , FROM/THRU/, COPY , DATE, SINCE, TIME , COMPARE 
Rules 
1. In form (1), the LISTOPT option must be specified. 


2. In form (2) the entire contents of an SMC entry and subordinate 
catalog and file are saved, the entire contents of SMC entries 
and their subordinate catalogs and files are saved with the 
exception of those SMC names appearing in the DONTDO clause, or 
only those SMC entries and subordinate catalogs and files whose 
SMC names appear in the DOONLY clause have their entire 
contents saved. The number of SMC entries listed in DONTDO or 
DOONLY clauses is limited to 150. 


3-41 BR38 


(2.A) 


In form (3), a section of the SMC entry and its subordinate 
catalogs and files are saved. The option permits either 
explicit master catalog names or numbers in lieu of names’ to 
indicate the section range. In addition, ***EOF may be used if 
the section is through the last master catalog name. The number 
"n" must be less than the number "m" or the total of master 
catalog names. If the number "m" is greater than the total of 
master catalog names, the system will assume ***EOF is 
intended. Numbers must be whole numbers; i.e., no decimals are 
permitted. An intermix of an explicit master catalog name anda 
number to indicate a section range is prohibited. 


To assign a "Save" tape to the FILSYS activity, the control 
card $ TAPE PS must be inserted into the deck, and to assign a 
"duplicate save" tape to the FILSYS activity the control card $ 
TAPE XS,... Should be inserted into the deck as illustrated in 
Appendix C. 


Files modified by the use of the FMOD directive and not written 
upon in the specified interval will not be saved when an 
attempt is made to save these files. That is, modification by 
use of the FMOD directive only does not constitute sufficient 
activity to have a file saved. 


Catalogs and files residing on structured removable packs will 
not be saved. However, sufficient information to restore the 
references to structured removable packs will be saved whenever 
they are encountered. 


The save process will have "PRIVATE" permission to the file 
while the file content is being saved. If the file is "busy", 
Save processing will wait up to two minutes for the file to 
become available. If the file remains "busy", the file content 
and file description will not appear on the save tape. 


Files in "defective" status and I-D-S files in "abort" status 
will not be saved. File content for nonstructured files will 
not be saved. 


SAVEMAST LISTOPT/YES/ 
The entire contents of the SMC entries and their subordinate 
catalogs and files are saved and their structure listed. 


SAVEMAST JOHNDOE ,LISTOPT/YES/ 
Only the SMC entries and their subordinate catalogs and files 
for JOHNDOE are saved and a list is prepared. 


(2.B) 


(2.C) 


(3.A) 


(3.B) 


(3.C) 


SAVEMAST DONTDO/JOHNDOE , JANEDOE/ 

The entire contents of the SMC entries and their subordinate 
catalogs and files, with the exception of those belonging to 
JOHNDOE and JANEDOE, are saved. No list is prepared. 


SAVEMAST DOONLY/JOHNDOE, JANEDOE/ 

SMC entries and their subordinate catalogs and files JOHNDOE 
and JANEDOE only have their entire contents saved. No list is 
prepared. 


SAVEMAST FROM/JOHNDOE/THRU/JANEDOE/ 

The "section" of the SMC entries and their subordinate catalogs 
and files from JOHNDOE thru JANEDOE is_ saved. No list is 
prepared. 


SAVEMAST FROM/JOHNDOE/THRU/** *EOF/ 

The "section" of the SMC entries and their subordinate catalogs 
and files from JOHNDOE thru the last entry is saved. No list is 
prepared. 


SAVEMAST FROM/#3/THRU/#10/ 

The "section" of the SMC entries and subordinate catalogs and 
files from the third entry through the tenth entry is saved. No 
list is prepared. 


SAVEMAST LISTOPT/YES/,COPY/YES/,COMPARE/YES/ 

The entire contents of all SMC entries and their subcatalogs 
and files are saved and structure listed. Data is written to 
both files and, upon completion, files are compared to insure 
that data is the same. 
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RESTOREMAST -- RESTORE MASTER CATALOG OR FILE 


The restore-master-catalog-or-file directive is used to allow the 
"privileged" user to restore the entire contents of SMC entries. and 
their subordinate catalogs and file; or to allow the "privileged" user 
to restore a specific SMC entry and its subordinate catalogs and files 
from a previous SAVE tape. Device master catalogs on removable media 
cannot be restored. 


Format 


The RESTOREMAST directive has the following forms: 


YES 
(1) RESTOREMAST LISTOPT/ NO (¢/ 
(2) RESTOREMAST J] name-n YES 
DONTDO/name-n,...,name-m/ [ erstoP2/ NO ‘| 


YES 
(3) RESTOREMAST COPY/4 NO (/ 


Options 
YES 
LISTOPT/¢{ NO ?/,DONTDO,DOONLY, COPY,DATE,SINCE,TIME 
Rules 


1. In form (1), the LISTOPT option must be specified. 


2. In form (2),the entire contents of an SMC entry and subordinate 
catalogs and files are restored, the entire contents of SMC 
entries and their subordinate catalogs and files are restored 
with the exception of those SMC names appearing in the DONTDO 
clause, or only those SMC entries and their subordinate 
catalogs and files whose SMC names appear in the DOONLY clause 
have their entire contents restored. The number of SMC entries 
listed in DONTDO or DOONLY clauses is limited to 150. 


3. To assign a "restore" tape to the FILSYS activity, the control 
card $ TAPE PR must be inserted into the deck, and to assign a 
"duplicate restore" tape to the FILSYS activity, the control 
card $ TAPE XR,... must be inserted into the deck as 
illustrated in Appendix C. 


4. The use of the COMPARE option in conjunction with the COPY 
option for the RESTOREMAST directive is meaningless, for 
COMPARE has no application to the restore process. 


5. The restore process will have "PRIVATE" permission to the file 
while the file content is being restored. 
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Examples 


(1) 


(2) 


(24) 


(3.B) 


(4) 


RESTOREMAST LISTOPT/NO/ 
The entire contents of the SMC entries and their subordinate 
catalogs and file are restored. No list is prepared. 


RESTOREMAST JOHNDOE,LISTOPT/YES/ 

Only the SMC entries and their subordinate catalogs and files 
for JOHNDOE are restored. The structure that is restored is 
listed. 


RESTOREMAST DONTDO/JOHNDOE , JANEDOE/ 

The entire contents of the SMC entries and their subordinate 
catalogs and files, with the exception of those belonging to 
JOHNDOE and JANEDOE, are restored. No list is prepared. 


RESTOREMAST DOONLY/JOHNDOE , JANEDOE/ 

SMC entries and their subordinate catalogs and files JOHNDOE 
and JANEDOE only have their entire contents restored. No list 
is prepared. 


RESTOREMAST DOONLY/JOHNDOE,JANEDOE/, LISTOPT/YES/, COPY/NO/ 
SMC entries and their subordinate catalogs and files for 
JOHNDOE and JANEDOE are restored. A listing of the entire 
contents of all SMC's is produced after the restore is 
completed. If an unrecoverable Tape Read error is encountered 
during the restore, FILSYS will skip the record in question. It 
will not attempt to locate a copy file, even if a $ TAPE XR,... 
control card exists. 
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AN EXAMPLE OF FILSYS-ACTIVITY LANGUAGE USAGE 


The following is an example of the use of the FILSYS-activity language. 
The example will refer to the following structure: 


SYSTEM MASTER CATALOG 


ee ee 
1 
ABCCORP 


2 


RECORDS PAYROLL 
INVENTORY 
5 
4 


3 


ON-ORDER 
6 
S (oe) | 
8 9 

Only those users that have an entry in the SMC are authorized to have 
permanent file space. This entry is created under the strict control of 
the individual or individuals responsible for assigning and maintaining 
permanent-file space. The assumption is that an SMC entry (entry 1 in 
the illustration) has been made with the following CRMAST directive. 


(The special control cards necessary to the use of a master directive 
are not shown here.) 


CRMAST ABCCORP/ABCCORD,PASSWORD/584031/, SIZE/10/, 
RESOURCES/1000/ 
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The following directive will allow user ABCCORP to create files on the 
structured removable DSS167 pack having serial number D352. He will be 
limited to 100 links of file space on that pack. 


CRPACK ABCCORP , DEVICE/167PK,D352/,SIZE/100/ 


Note 


Passwords are shown in the following examples for the sake of 
illustration; normally, they will be overlaid by pound. signs 
(#) in an actual source listing as a security measure. 


USERID 


CCREAT 


CPOS 


To identify the user in this example: 


USERID ABCCORPS584031 


Entry 2 is referred to as the UMC. It may be created explicitly 
if the user desires. If not, it will be created implicitly by 
the file system the first time a file or subcatalog is created. 
In this example, the entry will be created explicitly using the 
create-catalog (CCREAT) directive. 


To create entry 2: 


CCREAT ABCCORP, PASSWORD/XYZABC/, READ, READ/RFOX/,WRITE/RFOX/ 


Entries 3, 4, and 5 can now be created. Since they emanate from 
entry 2, it would be desirable to be able to position to that 
level and not have to repeat the catalog-string for each of the 
directives to create these entries. This can be accomplished by 
using the catalog-position (CPOS) directive. 


To position to entry 2: 


CPOS ABCCORPSXYZABC 


To create entries 3 and 4 (RECORDS will reside on the structured 
removable DSS167 pack having serial number D352): 


CCREAT RECORDS, READ,WRITE,DEVICE/167PK,D352/ 
CCREAT INVENTORY, READ, READ/RFOX, LPRATT/, 


WRITE/RFOX, LPRATT/, DEVICE/DSS167/, 
PASSWORD/76954/ 
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FCREAT 


CREL 


CLIST 


Entry 5 will be created using the create-file (FCREAT) direc 


tive 


and will be a nonstructured file residing on DSS167 pack with 


file serial number D282. 


To create entry 5: 


FCREAT PAYROLL, READ, READ/RFOX/,WRITE/RFOX/, 
MODIFY/RFOX/,SIZE/3,5/, PASSWORD/23507/, 
DEVICE/167PK ,D282/,FILEINFO/PAYROLL-PACK/ 


Entries 6 and 7 can now be created. Again, it is desirable 
take advantage of the CPOS directive. 


To position to entry 4: 


CPOS  ABCCORPSXYZABC/INVENTORYS76954 
To create entries 6 and 7: 

CCREAT ON-HAND 

FCREAT ON-ORDER 


Entries 8 and 9 can now be created. Again, it is desirable 
take advantage of the CPOS directive. 


CPOS ABCCORPS XY ZABC/INVENTORYS76954/ON-HAND 

To create entries 8 and 9: 

FCREAT PLANT, MODE/RAND/, SIZE/2/ 

FCREAT OFFICE ,PURGE/LPRATT/ ,MODIFY/LPRATT/ 

In order to release from current position, the catalog-rel 
(CREL) directive must be used. 

To release position: 

CREL 

The catalog-list (CLIST) directive can be used to have 
structure listed and have at one's disposal documentation of 
descriptions of the catalogs and files. 

To list "all" of ABCCORP: 

CLIST ABCCORP$XYZABC 


See Figure 3-1 for a sample listing. 
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CMOD 


To list "only" ABCCORP: 
CLIST ABCCORPSXYZABC, LISTOPT/ONLY/ 


See Figure 3-2 for a sample listing. 


To list "all" INVENTORY: 
CLIST ABCCORPSXYZABC/INVENTORY$76954 


See Figure 3-3 for a sample listing. 


To list "all" ON-HAND: 

CLIST ABCCORPS$XYZABC/INVENTORYS 76954/ON-HAND 

See Figure 3-4 for a sample listing. 

To list "all" RECORDS, including detail and subordinate 
information: 

CLIST ABCCORPS$ XY ZABC/RECORDS 

See Figure 3-5 for a sample listing. 

In addition to the directives that allow a user to create and 
list catalog/file structures there are the directives that 


perform maintenance functions. These latter directives affect 
only descriptions and not file content. 


The modify-catalog (CMOD) directive allows a user to modify an 
existing catalog description. 

To modify RECORDS: 

CMOD ABCCORPSXYZABC/RECORDS, NEWNAM/FILES/ 

RECORDS now must be referred to as FILES. If reference is made 
to old name, an error will occur. This can be demonstrated by 


trying to modify RECORDS again. 


CMOD ABCCORPS$XYZABC/RECORDS, NEWNAM/FILES/ 
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FMOD 


CPURGE 


This produces the error message: 


INCORRECT CAT/FILE DESCRIPTION 
and 


RKEKKKKKEKKKEKEKEKEKKKEKEKEKERKKEKKEKEKEKEKEKRKEKKKKKKKRKKKKKRKKKKKKE 


*** AN ERROR HAS OCCURRED - ONLY SYNTAX ANALYSIS 
FOKKER KKK KKK KKK KIRKE RR KEK AKER KKK AR EK RE KK KKEKEKRES 


KRREKEKKKEKKKEKEKEKEEKEKEKKERKEKEEKERKEKKRKKERKKKKKKKRKRKRKRKKKKKE 


WILL BE DONE ON THE DIRECTIVES REMAINING TO BE 
KH KKK IK KKK KK IK IK KERIKERI KERR RK RK KEK KEKE KKK 


REKKEKKKEKKRKEKRKE 


PROCESSED *** 
KREKKKEKKEKKEKERE 


The message that appears above would be strictly adhered to in 
an actual file-system activity run. In order to continue with 
our examples, however, it will be ignored. 


The modify-file (FMOD) directive allows a user to modify an 
existing file description. 

To modify PAYROLL: 

FMOD ABCCORPSXYZABC/PAYROLL$23507, READ/RFOX/,WRITER/RFOX/ 
PAYROLL has had its specific permissions for RFOX changed. This 
can be shown by listing ABCCORP and noting the specific 
permissions for PAYROLL. 

CLIST ABCCORPSXYZABC, LISTOPT/ONLY/ 

See Figure 3-6. 

The purge-catalog (CPURGE) directive allows a user to purge a 
catalog and all catalogs and files emanating from it. 

To purge catalog ON-HAND: 

CPURGE ABCCORPS$XYZABC/INVENTORY$76954/ON-HAND 

ON-HAND and all information subordinate to it has been purged. 
This can be shown by trying to modify one of the files’ that 
emanate from ON-HAND; namely, PLANT. Again, this produces’ the 


error message: 


INCORRECT CAT/FILE DESCRIPTION 
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FPURGE 


The purge-file (FPURGE) directive allows a_ user 
specific file. 


To purge ON-ORDER: 
FPURGE ABCCORPS$SXYZABC/INVENTORYS$76954/ON-ORDER 


ON-ORDER no longer exists. An attempt to purge it 
show this to be true. 


FPURGE ABCCORPS XYZABC/INVENTORYS$76954/ON-ORDER 
An error message is produced: 


INCORRECT CAT/FILE DESCRIPTION 
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to 


purge a 
again will 
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SAMPL 01 10-28-71 08.838 


BEGIN LIST ATs 


PARENT NAME 
CATALOG NAME 


FILE NAME 
ABCCORP 
Re CORUS 
INVENTORY 
PAYROLL 
(es) 
I 
ol 


iw) 


ae LEVEL 01 #a# 


INVENTORY 
ON+HAND 


ON-ORDER 


eee LEVEL 02 «#8 


ON*HAND 
PLANT 


OFFICE 


Ww 
(oe) 


ABCCORP 
ORIGINATOR 


ABCCORP 


ABCCOQRP 


ABCCORP 


ABCCORP 
ABCCORP 


ABCCORP 


ABCCORP 


FILCeE-=-SYSTEM ACTYVYITY PAGE 4 


GEN'| aeeeDEVICE [Denee sesnenveteeDATEestageatane eeeneenanaFiLE INFORMATIONstssetacone 


PERMS REQUESTED CURRENT ENTRY OF LAST JF LAST YOD OF TYPE aCCESS MAX LLINKS STATS 
RWAE CREATED AccCESS CHANSE CHANGE MODE SIZE USED 

R sTi STi. 10°26-71 10-28-71 10°28-71 

PASSWORD #XYZAaC 

SPECIFIC PERMISSIONS - VSERERFOX P3RMISSIONSRW 


DETAIL AND SUBORDINATE INFORMATION BYPASSED 
PARENT FOR STRUCTURE CONTAINED ON REMOVABLE DSS167 PACK, FILE SERIAL NyMBER,D352 


R pSS167 DP6 
PASSWORD $76954 
SPECIFIC PERMISSIONS - USERSRFOX 
SPECIFIC PERMISSIONS - USERILPRATT 


16°28-71 10-26-71 10728-7141 


PERMISSIONIRW 
PERMISSIONIRW 


10-28-71 10°28-71 10°28-71 08.842 ##NON-STRUCTURED FILE #* NULL 
FILE SERIAL NUMBER? D282 
#9666 


R DSS167 STi 
FILE NAMESPAYROLL#PACK 
LINK STRINGS: S20 
PASSWORD §23507 


SPECIFIC PERMISSIONS = USERSRFOX PERMISSION; RW M 


DP6 10-28-71 10°28-71 19723-71 

DPS 10-28-71 10728-7141 109728-71 08.844 SEQ N 12 12 NULL 
\P6 10-28-71 10728771 10728-7141 08,846 RAND N 24 24 NULL 
DP6 10-28-71 19728-71 10728-71 08.847 SEQ N 12 12 NULL 


SPECIFIC PERMISSIONS - USERSLPRATT PERMISSION} PM 


Figure 3-1. Listing of "All" ABCCORP 


SAMPL 01 10-28-71 08,838 


BEGIN LIST AT: 


PARENT NAME 
CATALOG NAME 


FILE NAME 
ABCCORP 
RECORDS 
bo 
' 
uo 
ee INVENTORY 
PAYROLL 


8cudd 


ABCCORP 


ORIGINATOR 


ABCCORP 


ASCCORP 


ABCCORP 


FILE +S Y STEM ACTIVITY PAGE 1 


GEN'’L aeeeDEVICE [Desee saeeenotanaDATEaetantesece ateaeeaeeeP ILE INFORMATLONeeeneenseee 


PERMS REQUESTED SURRENT ENTRY OF LAST JF LAST TOD OF TYPE ACCESS MAX 4LLINKS STATS 
RWAE CREATED ASCESS CHANGE CHANGE MODE SIZE USED 
R STi STi 10-28-71 16-28-71 10723-7141 


PASSWORD {8XYZARC 

SPECIFIC PERMISSIONS - USER: RF IX PERMISSIONS RW 

DETAIL AND SUBORDIVATE [NFORMATION BYPASSE) 

PARENT FOR STRUCTURE CONTAINED ON REMOVABLE 0SS167 PACK, FILE SERIAL NUMBERID352 


R DSS167 OP6 
PASSWORD 176954 
SPECIFIC PERMISSIONS ~- USERIRFOX 
SPECIFIC PERMISSIONS - USERILPRATT 


10°28-71 10°28-71 10728-7141 


PERMISSIONSRW 
PERMISSIONS RW 


R DSS167 3741 
FILE NAMES PAYROLL=PACK 
LINK STRINGS: §20 
PASSWORD 123507 
SPECIFIC PERMISSIONS - USER!SFOX 


10-28-71 10728-71% 10728-71 08.842 seNON-STRUCTURED FILE #* NULL 
FILE SERIAL NUYBER!ID282 
#2666 


PERMISSION3RW M 


Figure 3-2 Listing of "Only" ABCCORP 


PG-€ 


8eud 


SAMPL O01 10-28-71 08.838 


SEG]iv LIST AT: 
PARENT NAME 
CATALOG NAME 
FILE NAME 


INVENTORY 


ON-HAND 
ON-ORDER 


#e@ LEVEL O1 ##8 
ON“HAND 


PLANT 
OFFICE 


INVENTORY 
ORIGINATOR 


ABCCORP 


ABCCORP 


ABCCORP 


ASCCORP 
ABCCORP 


FILLe-eSYSTEM ACTIVITY PAGE 


by 


GEN'L ##eeDEVICE [navee seeevetteanDATEsstteeetane eeseeeeeneF ILE INFORMATIONeseeesaeaee 
PERMS REQUESTED SURRENT ENTRY OF LAST OF LAST TOD OF TYPE acCCesS MAX LL INKS STATS 


RWAE FREATED ACCESS SHANSE CWANGE MODE SIZE USED 
R ps$167 DP6 10-23-71 10°28-71 10-28-71 
PASSWORD 176954 
SPECIFIC PERMISSIONS ~- VSERIRFOX PERMISSIONSRW 
SPECIFIC PERMISSIONS = USERILPRATT PERMISSIONIRW 
DP6 10-28-71 19°28771 10728-71 
OP6 10-28-71 10728771 10728-71 08,844 SEQ N 12 12 
P6 10-2871 10°28-71 10728-71 08,846 RAND N 24 24 
DP6 40-28-71 10728771 10729-7121 08.847 SEQ N 12 12 
SPECIFIC PERMISSIONS - USERILPRATT PERMISSION} PM 


Figure 3-3. Listing of "All" INVENTORY 


NULL 


NULL 
NULL 


Soe 


8eud 


SAMPL 01 10-23-71 08.838 


BEGIN LIST AT; 
PARENT NAME 
CATALOG NAME 
FILE NAME 
ON@HAND 
PLANT \ 


OFFICE 


ON=HAND 


ORIGINATOR 


ABCCORP 
ABCCORP 


ABCCORP 


Frv.e=SYSTEM ACTIVITY PAGE 4 


GEN'|, weeeDEVICE [Deeee seenaneeneeDATEagteceeceee asteeneeeeaFiLE INFORMATIONssecesexeee 
PERMS REQUESTED CURRENT ENTRY OF LAST IF LAST TOD OF TYPE aCCESS MAX LLINKS STATS 


RWAE CREATED ACCESS SHANSE CHANGE MODE SIZE USED 
DPS 10-728-71 10-2871 19~28-71 
9P6 10-28-71 10-28-71 10-23-71 08.846 RAND N 24 24 NULL, 
DP6 10-26-71 19728771 {9-28-71 08,847 SEQ N 12 12 NULL 
SPECIFIC PERMISSIONS - USERILPRATT PERMISSION} PM 


Figure 3-4, Listing of "All" ON-HAND 


oS=¢ 


Od 
oO 


SAMPL 01 10-23-7141 08,838 


aEGIN LIST AT: 
PARENT NAME 
CATALOG NAMF 
FILE NAME 


RECORDS 


RECORDS 


ORIGINATOR 


ABCCORP 


FllLlersysgtreM ACTIVITY PAGE 1 


GEN'tL se#eeDEVICE [Danee eeeseeeeeeeDATEseeentaeees seeneaneeeP ILE INFORMATIONeenaesavaee 


PERMS REQUESTED SURRENT ENTRY F LAST OF LAST TOD OF TYPE ACCESS MAX LLINKS STATS 
RWAE CREATED ACCESS SHAN3E CHANGE MOD= SIZE USED 
Rw p7 10-28-71 10-28=71 19728-71 


PARENT FOR STRUCTURE CONTAINED ON 2EMOVA3LE DSS167 PACK, FILE SERIAL NUMRBERD352 


#e#* NO SUBORDINATE INFORMATION wae 


Figure 3-5. Listing of "All" RECORDS 


SAMPL O01 10-28-71 08,838 


BEGIN LIST AT: 


PARENT NAME 
CATALOG NAME 
FILE NAME 


ABCCORP 


FILES 


INVENTORY 


PAYROLL 


LS=E 


8eud 


ABCCORP 
ORIGINATOR 


ABCCORP 


A-BCCORP 


ABCCORP 


FILE -SYSTEM ACTIVITY PAGE 4 


GENtL seeanEVICE [jeeee saseeaeseeaepATEaateesaveee eceaatanaahILE INFORMATIONseseetenene 
PERMS REQUESTED SURRENT ENTRY OF LASy JF LASY OD OF TYPE ACCESS MAX LLINKS STATS 


RWAE CREATED ACCESS SHANSE CHANGE MODE SIZE USED 
R ST4 STi 10~28-71 10~28+71 19~28~71 

PASSWORD 8XYZABC 

SPECIFIC PERMISSIONS =< UsERSRFOX PERMISSIONS RW 


DETATL AND SUBORDINATE INFORMATION BYPASSED 
PARENT FOR STRUCTURE CONTAINED ON REMOVAALE DSS4167 PACK, FILE SERIAL NUMBER;D3352 


R DSS167 DP6 10728-7121 10728374 10728-7141 
PASSWORD 176954 
SPECIFIC PERMISSIONS ~ USERSRFOX PARMISSTONIRW 
SPECIFIC PERMISSIONS = USERILPRATT PERMISSIONSRW 
nS$167 STi 10~28-71 10-28-74 10°28-71 08,842 #eNON-STRUCTURED FILE #® NULL 
FILE NAMESPAYROLL=PACK FILE SERIAL NUMBER!D282 


LINK STRINGS: $=0 #™666 
PASSWORD $23507 
SPECIFIC PERMISSIONS - USERSRFOX P&RMISSIONSRW 


Figure 3-6. Listing Showing Modification of PAYROLL 
and Name RECORDS changed to FILES 


APPENDIX A 


ERROR MESSAGES 


The following error messages may be encountered during a FILSYS 
activity. 

1. FILE STAYS BUSY; TRY LATER 
If a file is in use during a perm-save operation, there is a 
waiting period of two minutes. If the file is still in use at _ the 
end of the waiting period, the error message is generated. The file 
structure and the file content are bypassed; they will not be 
saved. 

2. DESCRIPTION TOO LONG 
The catalog-string or catalog/file-string description contained 
over 50 names. 

3. UNDEFINED DEVICE TYPE XXXX 
UNDEFINED DEVICE NAME XXX 
An undefined device name or type has been specified. 

4. DIRECTIVE NOT IMPLEMENTED 
The current version of FILSYS does not contain an implementation of 
the directive used. 

5. EXPECTING A DIRECTIVE 
This message may be caused by a misspelled directive name or a 
syntax error (e.g., an embedded blank not following a comma). 

6. EXPECTING AN IDENTIFIER 
A syntax error has been made (e.g., PASSWORD//). 

7. EXPECTING AN INTEGER 
An upturned arrow marks the point at which a valid integer value is 
required. 

8. EXPECTING AN OPTION 


Some directive statements require at least one option (e.g., CMOD). 
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10. 


ll. 


12. 


ES 


14. 


Hoe 


16. 


17. 


INCORRECT CAT/FILE DESCRIPTION AT X....X 

Some error has been made in the catalog-string Or 
catalog/file-string specification other than an incorrect password, 
or the highest-level catalog name does not agree with the one 
established by the USERID directive. 

INVALID DELIMITER 

Use has been made of a symbol other than comma, slant, or dollar 
sign as a delimiter; the misuse of one of these; or an identifier 
exceeding 12 characters. An upward arrow identifies the symbol in 
error. 

INVALID INTEGER VALUE 

Use has been made of an integer over six digits long, use of one or 
more non-numeric digits, or the use of zero as a file-size 
specification. 

INVALID OPTION 

Use has been made of an option that is not applicable to the 
directive statement in which it was given. 

I/O ERROR ON DEVICE XXX SA = n...n 

An unrecoverable I/O error has been encountered on device XXX; the 
seek address is n...n. 


LINK SPACE EXHAUSTED, DEVICE XXX 


Additional file space is not currently available on device XXX. 


LLINK SPACE EXHAUSTED, DEVICE XXX 

Space for further catalogs or file definitions is not currently 
available on device XXX. 

NAME NOT IN MASTER CATALOG 

The master catalog name (name of SMC entry and UMC) given cannot be 
found in the SMC. 

NON-UNIQUE NAME 

An attempt has been made to modify a catalog or file with a name 


identical to one already existent at the same level, or the attempt 
to create an SMC entry synonymous to an existent one. 


18. 


19, 


20. 


21. 


22. 


23% 


24. 


25% 


26. 


27. 


OPTION NOT IMPLEMENTED 


The current version of FILSYS does not contain an implementation of 
the option used. 


PASSWORD X....X AT X.....X INCORRECT 


Either an incorrect password has been given, or one has been given 
where one is not required. 


PERMISSIONS DENIED 


One or more permissions have been requested, either explicitly 
($ PRMFL card) or implicitly, that have not been granted. 


SIZE REQUEST LS THAN ALLOCATED 


An attempt has been made to modify the maximum file size to a value 
less than the extent currently occupied by the file. 


SPACE REQUEST GR THAN ALLOWED 


A file-size specification has been made that would cause the user's 
total link space to exceed that allotted to him in the SMC. 


STATEMENT INCOMPLETE 


A syntax error has been made. 


ILLEGAL CHARACTER 


(This message has been deleted.) 


MASTER CATALOG ERROR 


An attempt has been made to save or list SMC entries at a time when 
none were known to the file system. 


FROM/THRU NAME UNDEFINED 


An attempt has been made to save a nonexistent SMC entry. 


TOO MANY) DONTDO| NAMES 
DOONLY 


Number of names specified exceeds the 150-name limit. 
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28. 


29. 


30. 


Sy 


32 


33's 


34. 


J 5% 


36% 


PRIVILEGED DIRECTIVE 


The deck setup does not contain the special control card required 
to permit a particular directive to be processed, 


NO USERID 

The deck setup does not contain a user-id directive prior to the 
use of other directives. 

INVALID USERID 


The user catalog name does not match the catalog description of the 
current directive being processed. 


SYSTEM MALFUNCTION 


An undefined system malfunction from which recovery cannot be made. 


UNRECOVERABLE TAPE ERROR 

An attempt to read an SMC record on a perm-restore tape is 
unsuccessful. The tape is spaced forward to the next SMC record. 
I-D-S FILE IN ABORT STATUS 

An I-D-S file is left in abort status whenever a slave job ends in 
an abnormal condition. If the I-D-S file is found in this condition 
during a perm-save operation, the catalog/file structure is saved 
but the contents of the file are bypassed. 

I-D-S FILE IN RECOVERY STATUS 

An I-D-S file is left in abort status whenever a slave job ends in 
an abnormal condition. If the I-D-S file is found in this condition 
during a perm-save operation, the catalog/file structure is saved 
but the contents of the file are bypassed. 

SEEK ERROR ON DEVICE XXX SA = n...n 

An address obtained from a catalog record is invalid on device XXX; 
seek address is n...n. 

FAILURE IN NAME SCAN (IMP.) 

A specified catalog/file entry cannot be located. If the entry is 


valid, the error message should not be generated; system 
malfunction is indicated. 
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37. 


38. 


39. 


40. 


41. 


42. 


43. 


UNDEFINED DEVICE (IMP.) 

A device name (e.g., DS1,DS2...) cannot be located in the .CRSCN 
table. If the device name is valid, the error message should not be 
generated; system malfunction is indicated. 


INTERNAL LINK TABLE CHKSUM ERROR 


Return from system to indicate malfunction. 


BAD STATUS ON FILE BODY I/0 


Error encountered in reading/writing file content during a 
perm-save or perm-restore operation. 


CHAR. RES. ON FILE BODY I/0 


Error encountered in reading/writing file content during a 
perm-save or perm-restore operation. 


# WORDS I/O NOT MULTIPLE OF 320 


Error encountered in reading/writing file content during a 
perm-Save or perm-restore operation. 


I/O ERROR DEACCESSING FILE 


An I/O error has occurred on a catalog record during a perm-save or 
perm-restore operation, after the file content has been processed. 


DOUBLE I/O ERROR DEACC. FILE 


An I/O error has occurred on a catalog record during a perm-save or 
perm-restore operation, after the file content has been processed. 
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44, 


45. 


46. 


47. 


48. 


49. 


INCONSISTENT FDW BLOCK COUNT 


The file descriptor words contained in the file description record 
are invalid. 


ILLEGAL USAGE OF OPTION 


The DONTDO and DOONLY options have both been used in one directive. 


PASSWORD REQUIRED AT X....X 


Password not given where one is required. 


ILLEGAL USAGE OF TALK OPTION 


An attempt has been made to assign the time-sharing TALK option to 
a SMC without having assigned the CARDIN option. 


ILLEGAL USAGE OF URGENCY OPTION 


An attempt has been made to assign an URGENCY to a SMC without 
having assigned the CARDIN option. 


DEVICE LINK TABLE CHKSUM ERROR 


Return for system to indicate malfunction. 


APPENDIX B 


SAMPLE DECK SETUP FOR FILSYS ACTIVITY 


<5 ENDIOB 


—a@—@§—— DIRECTIVES TO FILSYS ACTIVITY 


i FILSYS 


<q ——S$ IDENT 


<= ———_- S$. SNUMB 


If any of the directives reference structure contained on removable 
media, that media must be on-line at the time the directive is 
processed. This can be accomplished by including a S$ PRMFL card 
referencing a file contained on the media in the deck setup. 
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APPENDIX C 


SAMPLE DECK SETUP FOR FILSYS ACTIVITY USING SAVE OR RESTORE DIRECTIVES 


<____ $ ENDJOB 


| 
(4 DIRECTIVES TO 
mg CM FILSYS ACTIVITY 


1 PS for use of SAVE directive, PR for use of RESTORE directive 


2 xs for producing copy of save file, XR for copy of restore file. 


If the save or restore is to affect structure or files contained on 
removable media, that media must be on-line at the time the save or 
restore enters execution. This can be accomplished by including a 
$ PRMFL card referencing a file contained on the media in the deck 
setup. 
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Directive 


CCREAT 


CLIST 


CMOD 


CPOS 


CPURGE 


CREL 


CRELES 


CRMAST 


CRPACK 


DELMAS 


DELPAC 


FCREAT 


APPENDIX D 


TABLE OF DIRECTIVES 


Variable Field 


catalog-string 


catalog-string 


catalog-string 


catalog-string 
catalog-string 
none 

catalog-string 


master-catalog-name/ 
userid ,PASSWORD/password/, 


master-catalog-name 
master-catalog-name/ 
userid 
master-catalog-name 


catalog/file-string 


Options 


PASSWORD/password/ 
permissions 
DEVICE/forms 1 or 2/ 
LISTOPT/ J ALL | / 
ONLY 
NEWNAM/new name/ 
PASSWORD/password/ 


permissions 
DELETE 


none 
none 
none 
none 


RESOURCES/resources/ 
LODX 

CARDIN 

SIZE/size 

LODS 

LODSS 

TALK 

URGENCY 


DEVICE/type,number/ 
SIZE/size/ 


none 


DEVICE/type,number/ 


PASSWORD/password/ 
permissions 
DEVICE/forms 1 or 2/ 
MODE /mode/ 
ACCESS/access/ 
SIZE/size/ 


BR38 


FMOD 


FPURGE 


FRELES 


MASLST 


MODMAS 


MODPAC 


RELMAS 


RELPAC 


RESTORE 


RESTOREMAST 


catalog/file-string 


catalog/file-string 

catalog/file-string 

master-catalog-name 
or 


none 


master-catalog-name/ 
userid 


master-catalog-name 
master-catalog-name/ 
userid 
master-catalog-name 


catalog/file-string 


none 
or 


name 
DONTDO/namej / 
DOONLY/namej / 


NEWNAM/new name/ 


PASSWORD/password/ 


permissions 


DELETE 


SIZE/size/ 
ACCESS/access/ 


BUSY-FILE 


RESET (sust-rrce’ 7") 


IDS-ABORT 


none 


none 


pana 
O 


PASSWORD/password/ 


SIZE/size/ 


RESOURCES/resources/ 


LODX 
CARDIN 
LODS 
LODSS 
TALK 
URGENCY 


DEVICE/type,number/ 


SIZE/size/ 


none 


DEVICE/typeé ,number/ 


LISTOPT/ 


DOONLY 
DONTDO 


LISTOPT/ 


COPY 
DATE 
SINCE 
TIME 


YE 
NO 


YE 
NO 


ALL jf 
NLY 


sv / 


ae 


BR38 


SAVE catalog/file-string 
SAVEMAST none 
or 


name 
DONTDO/namej / 
DOONLY/namej / 


USERID master-catalog-name 
Spassword 


LISTOPT/ }] YES | / 
NO 

COPY 

COMPARE 

DATE 


SINCE 
TIME 


LISTOPT/ } YES \ / 
NO 
COPY 


COMPARE 
DATE 
SINCE 
TIME 


name name 
FROM/(number //THRUA number )/ 
* kX EOF 


none 


BR38 


APPENDIX E 


MERGE ACTIVITY PROGRAM 


MERGE ACTIVITY FUNCTION 


The Merge Activity program (MACT) permits a user to merge his saved perm 
files into one file containing the most recent contents of each perm 
file. This output file reflects the condition of the perm files at _ the 
time of the last save operation and is used to restore the files. 


The input files (the number may vary) for MACT are created by FILSYS in 
a Save operation. There must be at least one file created by the 
SAVEMAST directive or by a previous Merge operation. This file will 
contain the contents of the system master catalogs, subcatalogs, and 
files, and it must be given the file code MO. If other input files are 
to be created, file MO must be created first or an FS abort will occur. 
Other input files, if any, must be created by the same form of the 
SAVEMAST directive plus a combination of DATE, SINCE and TIME options. 
File codes for the additional input files must begin with Ml and 
continue sequentially. 


The following deck setup is needed to execute this program: 


al 8 16 

5 SNUMB 

SS IDENT 

$ PROGRAM MPSAVE , DUMP 

$ LIMITS ,24K,,10000 

$ TAPE MR,X1D, ,99999,MRGOUT1 
$ TAPE MS ,X2D, ,99999,MRGOUT2 
$ TAPE MO,X3D,,tttt,FULLSAVE 
iS TAPE M1,X4D,,tttt,SLCTSAVEL 
S$ TAPE M2,X5D, ,tttt,SLCTSAVE2 
S TAPE My ,X(y+3)D,,tttt,SLCTSAVEy 
MERGE options 

S ENDJOB 

**XKEOF 


where: tttt 
y 


tape reel number 
number of last file code 


The program MPSAVE is included in the software system library. 
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If the sequence of file codes is broken, the file codes after the break 
will not be used by the Merge program. In this program, output files MR 
and MS are written concurrently and can be used as input files for the 
RESTOREMAST operations or for another Merge operation. They permit the 
user to restore all permanent files to the condition of the last 
selective SAVEMAST. 


Processor run time and the number of SYSOUT lines required varies with 
the number of input files and the number of records to be processed for 
each file. The storage requirement also varies with the number of input 
files. It can be calculated as follows: 


1400 + n*3200 
where: n = number of input files 
If specified storage is inadequate, MACT will attempt to GEMORE the 


additional storage required. If adequate storage cannot be obtained, an 
FS abort occurs. 


The options for the Merge directive fall into two categories: selective 
merge and selective output. The options pertain to all input files and 
must be comma separated. 


The selective merge options are as follows: 


e If no selective merge options are specified (null option 
field), all system master catalogs from all input files are 
passed to the merge process. Only one Merge directive per 
activity will be processed. 


@e FROM/name-i/THRU/name-j/ 
The section of system master catalogs from name-i through 
name-j} are passed to the merge process. All others are 
bypassed. 

e DOONLY/name-1,name-2,...,name-n/ 
The system master catalogs specified are passed to the merge 
process, and all others are bypassed. 

e DONTDO/name-1,name-2,...,name-n/ 
All system master catalogs except those specified are passed to 


the merge process. The specified system master catalogs are 
bypassed. 
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The selective output options to the Merge directive are as follows: 


@ LISTOPT/YES or NO/ 


This option controls the listing of catalog/file structures 
passed to the merge process. If YES is given, a listing is 
produced. If NO is given, no listing is produced. If LISTOPT 
does not appear as an option, no listing is prepared. 


@ COPY/YES or NO/ 


This option controls the creation of a duplicate file. If YES 
is given, a duplicate file is generated concurrently with the 
original output file. If NO is given, or when no COPY option is 
specified, no duplicate file is produced. 


e COMPARE/YES or NO/ 


This option specifies a comparison of the merged files to 
ensure that both files contain exactly the same data. If YES is 
given, the COPY/YES/ option must also be given so that the 
comparison may be made. If NO is given or if the COMPARE option 
is not specified, the comparison will not be made even if the 
COPY option is used. If the two files are not the same (no 
compare), a message is entered in the processing commentary 
report and the merge process will be repeated. 


PROGRAM REPORTS 


This program generates three reports for the SYSOUT execution report. 
These reports resemble reports generated by FILSYS when it is processing 
a SAVEMAST directive. These reports are as follows: 


1. System master catalog summary including passwords associated 
with the system master catalog. 

2. System master catalog contents. 

3. Processing commentary including an indication of the number of 


print lines required. 


If an unrecoverable read error occurs on one of the input files created 
by FILSYS, MACT attempts to have the duplicate file mounted to continue 
processing. If there is no duplicate file, the merge process will be 
restarted. 


If an unrecoverable read or write error occurs on the merged file, the 
program will restart processing the file from the beginning. 
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DIAGNOSTIC MESSAGES 


If an unrecoverable I/O error occurs on I0C-i, unit cc, device dd, the 
operator gets the following message: 


** XUNRECOVERABLE I/O ERROR ON i cc dd***PROGRAM WILL RESTART 
MERGE OPERATIONS*** 


The error may be caused by a write to one of the merged files, a read of 
the merged files, or a read error from an input file that has no 
duplicate copy. MACT will attempt to reprocess from the beginning. 


If the merged files do not contain the same data, the operator will get 
the following message, and MACT will attempt to reprocess from the 
beginning: 


***COMPARE ERROR***PROGRAM WILL RESTART MERGE OPERATIONS*** 
If a file cannot be repositioned after a block serial error or an 
unrecoverable read error on an input file, the following message will be 


sent to the operator: 


***UNABLE TO REPOSITION 1 ce dd SUCCESSFULLY*** 


This message is followed by job termination with an FS abort code. 


JOB TERMINATION 
If the job terminated during the initialization phase before processing 
began the following message is given, followed by a reason: 


JOB TERMINATED 


The job terminates with an FS abort code. 


The specific reasons for the abort are listed after the error message. 
The specific reason my be any of the following: 


FULL SAVE FILE SHOULD HAVE BEEN ON i cc dd (FILE CODE M0), NOT ON 5 
ee ff 


The full save file was on device j ee ff, when it should have been on 
device i cc dd, which should have file code MO. This reason may also _ be 
given if a selective save file was created before the full save file. 
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If the header label for an input file was not created by FILSYS, the 
following reason is given: 


HEADER LABEL OF FILE fc AT: i cc dd, NOT MADE BY FILE SYSTEM 


where: fc = file code of input file in error 


When an attempt is made to run the merge program with no input files 
configured, the following reason is given: 


NO INPUT FILES CONFIGURED 


If the user did not request enough storage on the $ LIMITS card and did 
not use a $ LOWLOAD card, the following reason message is generated: 


USE A $ LOWLOAD CONTROL CARD 


If the user did not request enough storage on the $ LIMITS card and the 
resulting GEMORE request is denied, the following reason message is 
given: 


JOB NEEDS xxxx MORE WORDS OF MEMORY 


where: xxXxx = Number of additional words of memory requested by 
the GEMORE function 


PROGRAMMING EXAMPLES 


The following examples illustrate the variations of the Merge directive 
on the MPSAVE program: 


MERGE LISTOPT/YES/,COPY/YES/,COMPARE/YES/ 


The entire contents of all input files are used in the merge process. 
The contents and structures of all catalogs are printed, two tape files 
will be created concurrently, and at the completion of the merge 
process, the output files will be compared. If no directive is used in 
the merge process, the conditions specified in this example are 
automatically used. 


MERGE DOONLY/aaa,bbb,ccc,ddd/,LISTOPT/YES/ 
System master catalogs aaa, bbb,ccc, and ddd are passed to the merge 
process, and a listing of the structures is prepared. There is no 


duplicate file or comparison. 


MERGE LISTOPT/YES/,COPY/YES/ 
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The entire contents of all input files are passed to the merge process, 
a listing of the catalog structures is prepared, and a duplicate file is 
generated. No compare is made. 

MERGE COPY/NO/,COMPARE/YES/,DONTDO/xyz/ 


This is an illegal directive because of the contradiction between the 
COPY and COMPARE options. No merge is performed. 


MERGE 


All system master catalogs from all input files are passed to the merge 


process. No listing is prepared, only one output file is created, and no 
comparison is made. 
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